home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / ShareMailGiftware / xad_master / xad20 / Docs / xadUnTar.doc < prev    next >
Text File  |  2002-10-27  |  4KB  |  119 lines
  1. NAME
  2.     xadUnTar 1.7
  3.  
  4. SYNOPSIS
  5.     xadUnTar FROM/A,DEST=DESTDIR,PASSWORD/K,FILE/M,NAMESIZE/K/N,
  6.     FFS=OFS/S,SFS/S,INFO=LIST/S,Q=QUIET/S,AM=ASKMAKEDIR/S,
  7.     OW=OVERWRITE/S,NA=NOABS/S,ND=NODATE/S,NE=NOEXTERN/S,
  8.     NKP=NOKILLPART/S,NP=NOPROT/S,NT=NOTREE/S,SHORTNAME/S
  9.  
  10. DESCRIPTION
  11.     xadUnTar is a shell tool to extract data from Tar archives and
  12.     compressed Tar archives. This includes .tar.bz, .tar.bz2,
  13.     .tar.gz, .tar.Z, .tar and others.
  14.  
  15.     FROM specifies the file archive that should be handled.
  16.     DESTDIR is the destination directory. The directory is created
  17.     when it does not exist (except if ASKMAKEDIR is turned on and
  18.     you select no). There are some dangerous archives using absolute
  19.     path names (e.g. starting with LIBS: or RAM:). xadUnTar archives
  20.     these files to their absolute position (except NOTREE or NOABS is
  21.     used).
  22.  
  23.     PASSWORD can be used to supply a password for unarchiving of
  24.     encrypted archives. This argument requires the keyword PASSWORD.
  25.  
  26.     FILE allows you to select filename(s) (including patterns), which
  27.     should be extracted. When FILE is not given, all files are
  28.     extracted. With FILE only matching files are extracted.
  29.     NOTE: When you do not use NOTREE keyword, the patterns check
  30.     includes checks for directory structure as well.
  31.  
  32.     NAMESIZE allows to specify the maximum size of a filename. This is
  33.     useful as some archives from unix machines have longer filenames
  34.     than the Amiga filesystem allows. Whenever a name is longer than
  35.     the namesize value, you are asked to enter a shorter name. Names
  36.     of directories are truncated without requests.
  37.     FFS or OFS replace NAMESIZE argument and provide a standard length
  38.     of 30 characters, which is the value of our standard file system.
  39.     SFS provide a length of 100 characters, the SmartFilesystem
  40.     standard.
  41.  
  42.     NOEXTERN prohibits the use of external clients for
  43.     recognition purposes.
  44.     
  45.     INFO or LIST prints information about the archive and does not
  46.     do any unarchiving.
  47.     
  48.     OVERWRITE forces the program to overwrite an already existing
  49.     destination file. Normally you are asked about that.
  50.     
  51.     NOTREE skips all directory names and writes the files directly to
  52.     destination directory.
  53.  
  54.     SHORTNAME shortens the displayed name for INFO and extract. Now only
  55.     the filename instead of path and filename is presented.
  56.  
  57.     ASKMAKEDIR forces the program to ask you, if a missing directory
  58.     should be created.
  59.  
  60.     NOPROT prevents setting file protection bits and NODATE prevents
  61.     setting date information.
  62.  
  63.     NOABS prevents creation of absolute path names.
  64.  
  65.     If you specify NOKILLPART keyword, partial or corrupt output files
  66.     no longer are deleted.
  67.  
  68.     The QUIET option turns off the progress report, but also disables
  69.     questions to skip, rename or overwrite files.
  70.  
  71. EXAMPLES
  72.     Shell> xadUnTar archive.tar RAM:
  73.         Unarchive the tar archive to RAM:
  74.  
  75.     Shell> xadUnTar archive.tar.gz RAM: #?.txt #?.doc Contents
  76.         Unarchive all .txt and .doc file and the file "Contents" of
  77.         gzipped tar archive to RAM:
  78.  
  79.     Shell> xadUnTar archive.tar.bz LIST
  80.         Tells information about archive.tar.bz file.
  81.  
  82. HISTORY
  83.     xadUnTar 1.7
  84.     - added support for pipes and devices
  85.  
  86.     xadUnTar 1.6
  87.     - added support for second longname extension type
  88.  
  89.     xadunTar 1.5
  90.     - listing links works now as expected
  91.  
  92.     xadUntar 1.4
  93.     - bug fixes
  94.     - added support for name extension block types
  95.     - added SHORTNAME option
  96.  
  97.     xadUnTar 1.3
  98.     - plain tar archives are handled faster now
  99.  
  100.     xadUnTar 1.2
  101.     - handles empty files correct now
  102.  
  103.     xadUnTar 1.1
  104.     - little bug fix.
  105.  
  106.     xadUnTar 1.0
  107.     - First public release.
  108.  
  109. COPYRIGHT
  110.     xadUnTar is freely distributable for noncommercial use.
  111.  
  112. AUTHOR
  113.     Dirk Stöcker
  114.     Geschwister-Scholl-Straße 10
  115.     01877 Bischofswerda
  116.     GERMANY
  117.     
  118.     Dirk Stoecker <stoecker@epost.de>
  119.